home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / program / 386 / a68 / a68.doc next >
Text File  |  1985-11-19  |  3KB  |  109 lines
  1. ******************************************************************************
  2. *                         A68 - MC68000 ASSEMBLER                            *
  3. ******************************************************************************
  4.  
  5. (C) COPYRIGHT 1985 ROBERT G. BROWN
  6. ALL RIGHTS RESERVED
  7.  
  8. A68 VERSION 1.0 PLACED IN THE PUBLIC DOMAIN WITH THE PROVISION
  9. THAT IT NOT BE SOLD FOR PROFIT WITHOUT THE AUTHOR'S CONSENT.
  10.  
  11. A68 VERSION 2.0 IS PLANNED AS A COMMERCIAL RELEASE IN MID DECEMBER.
  12. CONTACT THE AUTHOR FOR FURTHUR INFO.
  13.  
  14. A68 TAKES A STANDARD 68000 ASSEMBLY LANGUAGE SOURCE FILE WITH THE
  15. EXTENSION .A68 AND PRODUCES A GEMDOS .PRG FILE.
  16.  
  17. THE COMMAND LINE TAKES THE FORM
  18. A68 filename
  19.  
  20. THE SOURCE FILE SHOULD CONTAIN STANDARD 68000 ASSEMBLY LANGUAGE
  21. AS DESCRIBED IN THE M68000 PROGRAMMER'S REFERENCE MANUAL.
  22.  
  23. EACH LINE TAKES THE FORM:
  24. [label] opcode[.ext] [source],[destination] [comments] or
  25. *[comments]
  26.  
  27. LABELS -  must start in the first column with a letter. They are
  28. valid to 6 characters and contain letters and digits. Lower case
  29. letters are converted to upper case by a68. A label must be
  30. follow by a white space character (TAB or SPACE).
  31.  
  32. COMMENT LINES - are indicated by a * in the first column.
  33.  
  34. OPCODE - must be preceded by white space. The ext is .b for byte
  35. .w for word and .l for longword. If left out .w is assumed. The
  36. branch instructions use .b and .w for short and long branch.
  37.  
  38. OPERANDS - must be prceded by white space and separated by a
  39. comma. The addressing modes follow the standard as follows:
  40.  
  41. SP is not accepted in place of A7 or a7.
  42.  
  43. The absolute short addressing mode is not supported by GEMDOS.
  44. Absolute long is assumed as the default unless .w is used as the extension.
  45.  
  46. The address register with displacement (with or without an index)
  47. mode is treated as follows:
  48.     d(An)    d is treate as an absolute displacement.
  49.  
  50. The program counter with displacement (with or without an index)
  51. mode is treated as follows:
  52.     d(PC)    d is treated as location to which a displacement
  53. is calculated.
  54.  
  55. For the displacement with index modes the length of the index
  56. must be specified by the .w or .l extension.
  57.  
  58. # indicates immediate data
  59.  
  60. $ indicates hex (i.e. #$ff is immediate data 255).
  61.  
  62. Only simple expressions are accepted by version 1.0. (no + - etc.)
  63.  
  64. THE FOLLOWING PSEUDO-OPS ARE SUPPORTED:
  65.  
  66. EQU
  67. label EQU value
  68. use the EQU to reference absolute memory locations. The locations
  69. referenced by a EQU are not relocated by GEMDOS.
  70.  
  71. ORG
  72.  ORG value
  73. use only as the first opcode in a file to create an absolute file
  74. without the GEMDOS relocation information.
  75.  
  76. DC.[ext]
  77.  DC.B 'string',$hexvalue,decimalvalue etc.
  78. defines constants of lenght .ext. Moves to next even address
  79. after DC.B.
  80.  
  81. DS.[ext]
  82.  DS.l value
  83. reserves value number of locations of length .ext.
  84.  
  85. DCB.[ext]
  86.  DCB.W count,value
  87. defines constant value count number of times.
  88.  
  89. A68 ERROR MESSAGES ARE REPORTED AS THE SOURCE CODE IS DISPLAYED
  90. ON THE CONSOLE IMMEDIATELY AFTER THE ERROR IN THE FORM <**En**>.
  91.  
  92. 1 - Illegal opcode
  93. 2 - Duplicate label
  94. 3 - undefined label
  95. 4 - illegal operand
  96. 5 - illegal size
  97. 6 - branch out of range
  98. 7 - displacement out of range
  99.  
  100. THE SYMBOL TABLE IS LISTED AT THE CONCLUSION OF THE ASSEMBLY AND
  101. A68 WAITS THE A SPACE BEFORE RETURNING.
  102.  
  103. IF YOU FIND A BUG PLEASE REPORT IT TO
  104.  
  105. BOB BROWN
  106. 53 CLIFF LANE
  107. LEVITTOWN N.Y. 11756
  108.  
  109. əəəəəəəəəəəəəəəəəəəəəəəəəəəəəəə